home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / program / tdev10.zip / TDE.DOC < prev    next >
Text File  |  1996-09-09  |  20KB  |  484 lines

  1.  
  2.                       ─┼─────────────────────────────┼─
  3.                        │  [T]he [D]ecoding [E]ngine  │
  4.                        ┼─────────────────────────────┼
  5.                        ├───────■ Version 1.0 ■───────┤
  6.                       ─┼─────────────────────────────┼─
  7.  
  8.             (c) 1995-96 by Alexander Curth - All Rights Reserved!
  9.  
  10.         [ 1.] Introduction
  11.         [ 2.] Requirements
  12.         [ 3.] Features
  13.         [ 4.] Installation
  14.         [ 5.] Usage / Usage in Crosspoint
  15.         [ 6.] Registering TDE
  16.         [ 7.] Disclaimer
  17.         [ 8.] Copyright
  18.         [ 9.] Trademarks
  19.         [10.] Bugreports, Errors & Problems
  20.         [11.] PGP-KEY of the Author
  21.         [12.] Errorlevels / Usage in batch Programs
  22.         [13.] Support-BBS
  23.  
  24.         [ 1.] Introduction to [T]he [D]ecoding [E]ngine (TDE)
  25.         ─────────────────────────────────────────────────────
  26.         TDE   was  especially  designed  to   decode  LARGE  Buffers  in
  27.         USENET-Format  (including Subjectlines  etc.) or ZCONNECT-Format
  28.         (Crosspoint,  etc.)  which contain lots  of encoded Binaries you
  29.         can recieve via the Internet! Most Pointprograms and Newsreaders
  30.         are able to decode these Binaries, but the decoding routines are
  31.         often  not complete or not userfriendly or they have problems to
  32.         decode  multi-part files etc., so I  had to write my own Decoder
  33.         and here is the result!
  34.  
  35.         TDE  is SHAREWARE that means you have to register it, if you use
  36.         it after a trial time of 30 days - Thanks!
  37.  
  38.         IMPORTANT NOTE:
  39.         ───────────────
  40.         The  Bufferfile  has to be  in standard PC-TEXT-MODE, that means
  41.         that   each   line  has  to   end  with  $0D0A  !!!  (Exception:
  42.         Crosspoint-Binaries   Files)  So  PLEASE  make  sure  that  your
  43.         Bufferfiles  are  in  PC-TEXT-MODE,  otherwise  TDE  will decode
  44.         nothing... THIS IS NOT A BUG!
  45.  
  46.         Solution:
  47.         o Convert  the  Bufferfile with  an Editor etc. to PC-TEXT-MODE!
  48.           (Load  the  Bufferfile into an Editor  and  then save it. This
  49.           should help!)
  50.  
  51.         o If  there  are  enough requests  of  REGISTERED  users, I will
  52.           change this behaviour in one of the future Versions...
  53.  
  54.         ================================================================
  55.  
  56.         [ 2.] REQUIREMENTS:
  57.         ───────────────────
  58.         - PC (compatible) running MS-DOS (compatible)
  59.         - 286 or higher Processor
  60.         - 400KB (or more) free Basemem
  61.         - CJPEG.EXE if you want to convert .GIF etc. to .JPG
  62.           (CJPEG.EXE is Freeware and can be download in lot's of BBS's)
  63.         - OPTIONAL:  PKUNZIP.EXE, LHA.EXE, ARJ.EXE, GZIP.EXE and RAR.EXE
  64.           to  test archive-integrity (Download  them from any FTP-Server
  65.           or your local BBS, if you don't have them)
  66.         - A valid TEMP environment variable
  67.           I recommend a Ramdisk (at least 2 MB) to speed up the decoding!
  68.  
  69.         Note:
  70.         Disk-Read/Write-Caches (e.g. SMARTDRIVE) or WINDOWS95 will speed
  71.         up TDE, too!
  72.  
  73.         TDE HAS BEEN TESTED WITH:
  74.         ─────────────────────────
  75.  
  76.         Program     │ Version
  77.         ────────────┼───────────────────────────
  78.         MS-DOS      │ V6.22 & V7.00 (WINDOWS 95)
  79.         CROSSPOINT  │ V3.11
  80.         F-PROT      │ V2.24
  81.         PKUNZIP     │ V2.04g
  82.         ARJ         │ V2.50a
  83.         LHA         │ V2.55b
  84.         RAR         │ V2.00
  85.         GZIP        │ V1.2.4
  86.         CJPEG       │ V6.0
  87.  
  88.         ================================================================
  89.  
  90.         [ 3.] FEATURES:
  91.         ───────────────
  92.         - Supports UUE, XXE & BASE64 Decoding
  93.         - Decodes Buffers up to 9 GIGABYTE!
  94.         - Fast (ASM) Decoding-Routines
  95.         - Supports automatic & 'intelligent' Errorfixing
  96.           (repairs Messages, if possible)
  97.         - 100% Crosspoint(XP) compatible
  98.         * Removes decoded Messages automaticly from Crosspoint(XP)
  99.         - Extracts Crosspoint(XP)-Binaries
  100.         - Logfile for Crosspoint(XP)
  101.         - Handles  up to ten different Bufferfiles and decodes them like
  102.           one large Bufferfile
  103.         - Automaticly repairs .JPG Files (if possible)
  104.         - Decoding handles single files and multi-part files
  105.           (EVEN IF THEY ARE RECIEVED NOT IN THE CORRECT ORDER)
  106.         - Supports Error-Logging with usefull Descriptions
  107.         - Supports automatic detection & renaming of duplicate Files
  108.         * Supports automatic conversion of .GFX to .JPG (requires CJPEG)
  109.         - Supports automatic testing of ZIP, ARJ, RAR, LZH/LHA, Z archives
  110.         - Supports automatic Virusscanning of executeable files
  111.           (requires F-PROT)
  112.         - Supports Signature-check for:
  113.           .JPG.GIF.ZIP.ARJ.MPG.BMP.EXE.VOC.Z.MID.XM.TIF-Files
  114.         * Supports automatic testing of JPG pictures
  115.         * Supports automatic deletion of identical duplicate Files
  116.           (CRC-32 based)
  117.         - 'Nice' Statusscreen (;
  118.         * Support of sorting/moving the extracted files into subdirs
  119.         - LOW REGISTRATION FEE: $25 OR 25,- DM (Updates are for free!)
  120.  
  121.         * = THESE  FEATURES ARE ONLY AVAILABLE IN THE REGISTERED VERSION
  122.             OF TDE!
  123.  
  124.         IF  YOU  ARE STILL NOT CONVINCED  THAT TDE IS THE BEST AVAILABLE
  125.         UUE,XXE,B64 (MIME)-DECODER SO FAR, THEN FEEL FREE TO COMPARE THE
  126.         *RESULTS* OF TDE WITH YOUR FAVORITE ONE...
  127.  
  128.         ================================================================
  129.  
  130.         [ 4.] INSTALLATION:
  131.         ───────────────────
  132.         - Copy the files TDE.* into a DOS-"PATH" or in a Directory
  133.         - Change to the directory where the files TDE.* are located
  134.         - Configure TDE with "TDE.EXE /C"
  135.  
  136.         ================================================================
  137.  
  138.         [ 5.] USAGE
  139.         ───────────
  140.         - "TDE.EXE /C"
  141.         to Configures TDE
  142.         - TDE.EXE <BUFFERFILENAME>
  143.         to decode all binaries from <BUFFERFILENAME>
  144.         - TDE.EXE /L
  145.         to  process  all files (max. 10),  which are defined in the file
  146.         TDE.LST!  (The first line must  contain the first bufferfile and
  147.         so on...) The first File HAS TO exist, otherwise you will get an
  148.         errormessage!  All other files given in the list will be skiped,
  149.         if  they don't exist! All these  bufferfiles will be handled and
  150.         decoded  if they would be "one"  bufferfile! (That means even if
  151.         parts  of  a multipart-message are  stored in different buffers,
  152.         the  message  would be decoded  correctly!) The bufferfiles will
  153.         NOT  be copied to one large bufferfile on the HD, they will only
  154.         be processed like "one" bufferfile!
  155.  
  156.         Here is an example for a TDE.LST file:
  157.  
  158.         -cut-
  159.         c:\buffer.10
  160.         c:\buffer.11
  161.         c:\buffer.12
  162.         c:\buffer.13
  163.         c:\buffer.14
  164.         c:\buffer.15
  165.         c:\buffer.16
  166.         c:\buffer.17
  167.         c:\buffer.18
  168.         c:\buffer.19
  169.         -cut-
  170.  
  171.         NOTE:
  172.         If  you don't have TDE in a PATH and if you want to call it from
  173.         a batchfile you have to do it this way:
  174.  
  175.         -CUT-
  176.         rem You *HAVE TO* change to the TDE-DIRECTORY first!
  177.         C:
  178.         CD C:\TOOLS\TDE
  179.         TDE.EXE %1
  180.         -CUT-
  181.  
  182.         USAGE IN CROSSPOINT
  183.         ───────────────────
  184.         As  I  don't  have an english  version  of  Crosspoint, I cannot
  185.         describe  how  to install TDE in  the english version of XP! (If
  186.         you  are interested to install TDE into XP, then read the german
  187.         doc! (TDE.DOK) Even if you don't understand german, the pictures
  188.         may help you, if not then contact me...)
  189.  
  190.         ================================================================
  191.  
  192.         [ 6.] REGISTERING TDE
  193.         ─────────────────────
  194.         The  registered  version has EXTRA-FEATURES  (see  above) and is
  195.         able to work in batch-mode (there are no Shareware-Screens)
  196.  
  197.         If  you  have registered TDE once,  you  will always (*) get the
  198.         latest   version  of  TDE   (registered  to  your  Name/Company)
  199.         PGP-CRYPTED via E-mail for free.
  200.  
  201.         NOTE
  202.         ────
  203.         This  service is only available as long as you don't change your
  204.         E-mail  address or PGP-key! In this case you can re-register for
  205.         a  lower  price:  $5 or 5,-  DM!  (This is necessary, because it
  206.         means extra-work for me)
  207.  
  208.         Maybe  I  will use someday a  code-system! In this case you will
  209.         not  get any longer updates via E-mail, but all registered users
  210.         of  TDE  will  get a code! With  this  code you can register the
  211.         Sharewareversion, so you still can update TDE for free!
  212.  
  213.         HOW TO REGISTER TDE
  214.         ───────────────────
  215.         (1)
  216.         You *NEED* a PGP-KEY!
  217.  
  218.         - the USER ID has to be in this form:
  219.           'REALNAME <your@e-mail.adress>'
  220.  
  221.         - Here a few info's for you, if you don't have a PGP-KEY:
  222.           o PGP is free for private use!
  223.           o Quick instructions, how to generate a PGP-Key in 5-10 min. ,
  224.             will follow in this documentation!
  225.  
  226.         NOTE:
  227.         I  will  ship the REGISTERED VERSION  of TDE *ONLY* crypted with
  228.         your  PUBLIC-PGP-KEY  over the Internet  (guess why...) In other
  229.         words:  If you send me money, but no REGISTER.ENG INCLUDING YOUR
  230.         PGP-KEY,  then  don't  expect  to  recieve  anything  from me in
  231.         return, so please follow the rules!
  232.  
  233.         IF  YOU  ALLREADY  HAVE  SUCH  A  PGP-KEY,  THEN  GOTO  (2) ELSE
  234.         CONTINIUE READING
  235.  
  236.         - Download PGP263.ZIP or PGP263I.ZIP from
  237.           ftp://ftp.ifi.uio.no/pub/pgp/
  238.           ftp://ftp.ox.ac.uk/pub/crypto/pgp/
  239.           ftp://ftp.dsi.unimi.it/pub/security/crypt/PGP/
  240.           ftp://ftp.informatik.uni-hamburg.de/pub/virus/crypt/pgp/
  241.           other ftp servers or one of your local BBS's
  242.  
  243.         - Install the PGP-Program
  244.  
  245.         - Create your SECRET & PUBLIC PGP-KEY(S) with:
  246.           "PGP -kg" and follow the instructions on the screen!
  247.  
  248.         - Select a Key with any size (I recommend 1024)
  249.  
  250.         - Enter your REALNAME and your E-MAIL address like in  the given
  251.           example, if you are prompted to enter your USER ID!
  252.  
  253.         - REMEMBER THE PASS PHRASE YOU ENTER!!!
  254.           (better do not write it down!)
  255.  
  256.         IMPORTANT
  257.         ─────────
  258.         STORE  YOUR SECRET KEY ON A SAFE  PLACE AND NEVER GIVE YOUR PASS
  259.         PHRASE TO ANYBODY ELSE!
  260.  
  261.         - Extract your PUBLIC KEY from the keyring with:
  262.         "PGP -kxa <your user ID> MYKEY.ASC"
  263.  
  264.         If your REALNAME is e.g. JIM SMITH then you have to enter:
  265.         "PGP -kxa JIM mykey.asc"
  266.  
  267.         The  file  MYKEY.ASC will contain  your PUBLIC PGP-KEY, that you
  268.         have to append to the REGISTER.ENG!!!
  269.  
  270.         (These  are  just QUICK docs how  to  create your PGP-Key(s), so
  271.         please  read the PGP.DOC if you want  to know more about PGP and
  272.         do not ask me, thanks!)
  273.  
  274.         (2)
  275.         Fill  out the REGISTER.ENG and append your PUBLIC-PGP-KEY to the
  276.         REGISTER.ENG
  277.  
  278.         (3)
  279.         Send the REGISTER.ENG to my E-Mail-Address!
  280.  
  281.         (4)
  282.         The  registration fee (**) is $25 (US DOLLAR) or 25,- DM (German
  283.         currency)
  284.  
  285.         Payment:
  286.  
  287.         Unfortunately  my  bank charges me  fees for foreign EuroCheques
  288.         and  for foreign remittance orders, so you have to add $15 (US$)
  289.         or  15,- DM to the registration fee  of TDE if you choose one of
  290.         these modes of payment! (You have to pay $40 (US$) or 40,- DM)
  291.  
  292.         a) REMITTANCE:
  293.  
  294.         Bank        : BERLINER SPARKASSE , GERMANY
  295.         Bank code   : 100 500 00
  296.         Account no. : 240369394
  297.         Reciever    : ALEXANDER CURTH
  298.         Attn        : YOUR E-MAIL-ADDRESS
  299.  
  300.         b) INTERNATIONAL POSTAL MONEY ORDER:
  301.  
  302.         You  have to go to your local post office and tell them that you
  303.         want  to send someone in Germany xx,- DM (German currency). They
  304.         will  give you a form to fill out, the postal clerk will look at
  305.         the conversion table and you will pay the equivalent in your own
  306.         currency. Some days later my postman brings me the money.
  307.  
  308.         c) SEND IT TO MY ADDRESS:
  309.  
  310.         ALEXANDER CURTH
  311.         EMDENER STR. 30
  312.         10551 BERLIN / GERMANY
  313.  
  314.         - as CASH / only in DM (German currency) or US$ (BILLS!)
  315.  
  316.         - as an EUROCHEQUE / only in DM (German currency)
  317.  
  318.         NOTE
  319.         ────
  320.         Do  no  forget  to  write your  NAME  and  E-MAIL-ADDRESS at the
  321.         backside   of  the  envelope  and  please  make  sure  that  the
  322.         money/cheque is not visible through the envelope - Thanks!
  323.  
  324.         (5)
  325.         AS SOON AS I RECIEVE YOUR MONEY, I WILL SEND THE REGISTERED COPY
  326.         CRYPTED  WITH YOUR PUBLIC-PGP-KEY TO YOUR E-MAIL-ADRESS! (If you
  327.         do  not get your registered copy  within 20 days, after you have
  328.         send me the money and the REGISTER.ENG, then contact me!)
  329.  
  330.         (6)
  331.         If  you  recieve the mail from  me that contains YOUR REGISTERED
  332.         COPY of TDE, then decrypt it with:
  333.         - "PGP -p <messagefilename>"
  334.         - Enter your PASS PHRASE
  335.         - Extract the ZIP and copy the TDE.EXE over the previous Version
  336.  
  337.         (**) ALL   PRICES  ARE *ONLY* VALID IF  YOU  WANT TO USE TDE FOR
  338.              PRIVATE   REASONS!   IF   YOU  WANT   TO   USE   TDE  IN  A
  339.              COMMERCIAL-BBS, COMPANY, ETC. THEN YOU HAVE TO PAY $200 (US
  340.              DOLLAR)  OR  200,- DM! IF YOU  WANT  TO REGISTER 10 OR MORE
  341.              COPIES OF TDE, THEN ASK ME FOR SPECIAL PRICES!
  342.  
  343.         ================================================================
  344.  
  345.         [ 7.] DISCLAIMER
  346.         ────────────────
  347.         THIS  SOFTWARE IS PROVIDED "AS IS". THERE IS NO WARRANTY, WETHER
  348.         EXPRESS  NOR IMPLIED. THE AUTHOR DOES NOT ACCEPT ANY LIABILITIES
  349.         WITH RESPECT TO THIS PROGRAM. USE THIS PROGRAM ON YOUR OWN RISK!
  350.         IF YOU DON'T AGREE WITH THIS, THEN DELETE IT!
  351.  
  352.         ================================================================
  353.  
  354.         [ 8.] COPYRIGHT
  355.         ───────────────
  356.         You are allowed to copy the *SHAREWARE-VERSION* of TDE for free.
  357.         You  may distribute the program to others  as long as you do not
  358.         charge any fee and as long as there are no changes made with the
  359.         program,   this  documentation  and  as   long  as  the  package
  360.         TDE-Vxx.ZIP is complete.
  361.  
  362.         ================================================================
  363.  
  364.         [ 9.] TRADEMARKS
  365.         ────────────────
  366.         ARJ is copyright 1990-96 by ARJ Software
  367.         CROSSPOINT (XP) is copyright by Peter Mandrella
  368.         F-PROT is copyright by Frisk Software International
  369.         GIF is a service mark of CompuServe Incorporated
  370.         GZIP is copyright 1992-1993 by Jean-loup Gailly
  371.         LHA is copyright 1988-92 by Haruyasu Yoshizaki
  372.         MS-DOS is a trademark of Microsoft Corporation
  373.         PGP is copyright 1990-1994 by Philip Zimmermann
  374.         PKZIP/PKUNZIP are copyright 1989-1993 PKWARE Inc.
  375.         RAR is copyright 1993-96 by Eugene Roshal
  376.         WINDOWS 95 is a trademark of Microsoft Corporation
  377.  
  378.         ================================================================
  379.  
  380.         [10.] BUG-REPORTS
  381.         ─────────────────
  382.         All    decoded   files   with   errors   will   be   stored   in
  383.         <EXTRACTPATH>\_ERROR!  The Error-Descriptions are  stored in the
  384.         file <EXTRACTPATH>\_ERROR\!ERROR.LOG
  385.  
  386.         PLEASE NOTE:
  387.         Not  all recognized errors are 'BUGS'  of TDE!!! So please check
  388.         *first*  if the error-description in the !ERROR.LOG is valid! If
  389.         not  and if you are able to decode the file with another decoder
  390.         errorfree  or if you are able to  decode the file after you have
  391.         done  some changes in the buffer, then  you can say it's a 'BUG'
  392.         in  TDE and *ONLY IN THIS CASE* I would really appriciate it, if
  393.         you  contact me (send me the !ERROR.LOG  and the message - if it
  394.         is not larger than 250 Kb) Don't worry about the contents of the
  395.         message (Picture, Text, Sound, etc.) I really don't care as long
  396.         as it is not of illegal nature!
  397.  
  398.         If PKUNZIP, ARJ, LHA/LZH, RAR or F-PROT returns an errorlevel of
  399.         255 then there are two possible reasons:
  400.         - there  is an error in the  CFG-File! (check the path etc. with
  401.           "TDE /C")
  402.         - there    is   too  less   free   base-memory  to  execute  the
  403.           test-program!  (Try  to increase your  free memory or turn the
  404.           option off!)
  405.  
  406.         If TDE crashes/hangs then you should do this:
  407.         - Enter the DOS-Shell and type "SET TDEDEBUG=ON" + <CR>
  408.         - Let TDE decode the buffer with the error again!
  409.         - Note the Subject (the red line) of the message wich causes TDE
  410.           to crash!
  411.         - Search for the message with the Subject in your mailer
  412.         - Extract this message (if multipart: all parts)
  413.         - Decode this message/s
  414.         - If the error still appears, then send the message/s to me!
  415.           (incl. Header & Body!)
  416.         - If  the error appears not again,  then try to find the message
  417.           that causes the error and send it to me!
  418.  
  419.         If   you   discover  other  BUGS,   then   send  me  a  detailed
  420.         error-description, or tell me what I have to do to reproduce the
  421.         error! (if you can...)
  422.  
  423.         PLEASE SEND BUG-REPORTS & SUGGESTIONS TO:
  424.  
  425.         alexc@kitembx.in-berlin.de
  426.  
  427.         Ps: If you report bugs, then please let me know which version of
  428.             TDE you use!
  429.  
  430.         THANKS!
  431.  
  432.         ================================================================
  433.  
  434.         [11.] PGP-KEY OF THE AUTHOR
  435.         ───────────────────────────
  436.  
  437.         -----BEGIN PGP PUBLIC KEY BLOCK-----
  438.         Version: 2.6.3i
  439.  
  440.         mQCNAzEvkR8AAAEEANQMAv9CcBLBgA58qMvrbLfQTuuR8hkS1WQUh17aqMdu42OU
  441.         G9kqmEzRMd5t2fdF+HIlHBpEqlPmhtRQx1z0z1Axt5c0B5sl+RWfQvvZQbBeFSMP
  442.         lKbPDOFM8NgVmjp1Md4gCaNHNmjcNGT2VN8X/cqJkFILPyY1wL6FWFlm32tZAAUR
  443.         tCxBbGV4YW5kZXIgQ3VydGggPGFsZXhjQGtpdGVtYnguaW4tYmVybGluLmRlPg==
  444.         =fGrM
  445.         -----END PGP PUBLIC KEY BLOCK-----
  446.  
  447.         ================================================================
  448.  
  449.         [12.] ERRORLEVELS / (FOR USAGE IN BATCH PROGRAMS)
  450.         ─────────────────────────────────────────────────
  451.         ERRORLEVEL: 1 = no Error
  452.         ERRORLEVEL: 0 = fatal Error
  453.  
  454.         ================================================================
  455.  
  456.         [13.] SUPPORT-BBS
  457.         ─────────────────
  458.         You can download the latest Sharewareversion of TDE for free at:
  459.  
  460.         Kiteflyer BBS Berlin
  461.  
  462.         +49-30-6690016 ISDN X75
  463.         +49-30-6690017 ISDN X75 / Analog Zyxel 19k2
  464.         +49-30-6690018 Analog USR 33K6
  465.  
  466.         Online Account
  467.         ─────────────-
  468.         Login   : TDE                    <CR>
  469.         Password: tde (case sensitive!)  <CR>
  470.  
  471.         then enter:
  472.         files                            <CR>
  473.         cd dos tools                     <CR>
  474.         list TDE*                        <CR>
  475.         down TDE-Vxx.zip                 <CR>
  476.  
  477.         ================================================================
  478.  
  479.         Ps:
  480.         Sorry  for  my  bad english! Feel  free  to  send me a corrected
  481.         TDE.DOC!
  482.  
  483.         That's all!
  484.